home *** CD-ROM | disk | FTP | other *** search
/ Web Designer 98 (Professional) / WebDesigner 1.0.iso / cgi2 / links_tar.z / links_tar / links / README < prev   
Encoding:
Text File  |  1996-07-27  |  7.6 KB  |  134 lines
  1. ##############################################################################
  2. # Free For All Link Page        Version 2.2                                  #
  3. # Copyright 1996 Matt Wright    mattw@worldwidemart.com                      #
  4. # Created 5/14/95               Last Modified 7/17/96                        #
  5. # Scripts Archive at:           http://www.worldwidemart.com/scripts/        #
  6. ##############################################################################
  7. # If you run into any problems while trying to configure this scripts, help  #
  8. # is available.  The steps you should take to get the fastest results, are:  #
  9. #       1) Read this file thoroughly                         #
  10. #       2) Consult the Matt's Script Archive Frequently Asked Questions:     #
  11. #               http://www.worldwidemart.com/scripts/faq/             #
  12. #       3) If you are still having difficulty installing this script, send   #
  13. #          e-mail to: scripts-help@tahoenet.com                     #
  14. #          Include any error messages you are receiving and as much detail   #
  15. #          as you can so we can spot your problem.  Also include the variable#
  16. #          configuration block that is located at the top of the script.     #
  17. #                                         #
  18. # Hopefully we will be able to help you solve your problems.  Thank you.     #
  19. ##############################################################################
  20. # COPYRIGHT NOTICE                                                           #
  21. # Copyright 1996 Matthew M. Wright  All Rights Reserved.                     #
  22. #                                                                            #
  23. # Free For All Links may be used and modified free of charge by anyone so    #
  24. # long as this copyright notice and the comments above remain intact.  By    #
  25. # using this this code you agree to indemnify Matthew M. Wright from any     #
  26. # liability that might arise from it's use.                                  #
  27. #                                                                            #
  28. # Selling the code for this program without prior written consent is         #
  29. # expressly forbidden.  In other words, please ask first before you try and  #
  30. # make money off of my program.                                              #
  31. #                                                                            #
  32. # Obtain permission before redistributing this software over the Internet or #
  33. # in any other medium.    In all cases copyright and header must remain intact.#
  34. ##############################################################################
  35.  
  36. This is a script built for the World Wide Web that allows users to freely
  37. add links to your page in the sections that you specify.
  38.  
  39. File included in this script:
  40.         1) links.html - The HTML File users see
  41.         2) links.pl - The guts of the operations
  42.         3) README - This file (Installation information)
  43.  
  44. To Install:
  45. a) You must have access to execute CGI scripts on your server.
  46. b) Put the links.pl file into your server's cgi-bin or rename it to links.cgi
  47.     (Whichever is required on your server).
  48. c) Put the links.html file into any dir of your choice (must be user writable)
  49. d) Shoul dbe compatible with Version 2.1, so just modify links.pl and try 
  50. it.. I am not sure though. :-)
  51.  
  52. LINKS.PL
  53. This file is the file that pulls in your links.html and makes the necessary 
  54. changes to your links.html.  It will add the url of the user's choice.  You 
  55. must chmod this file 755 and place it in your server's cgi-bin.  You may need
  56. to rename this to links.cgi if your server requires that sort of thing.
  57.         EDIT VARIABLES IN THIS FILE:
  58.                 $filename = "/server/path/to/links.html" 
  59.                         Path Location of your links.html file.
  60.                 $linksurl = "http://your.server/actual/url/of/links.html" 
  61.                         URL Location of links.html file.
  62.                 $linkscgi = "http://your.host.xxx/cgi-bin/links.pl";
  63.                         URL Location of links.pl.
  64.                 $linkstitle = "Free For All Link Page"
  65.                         Title of Your Page
  66.         $database = "/path/to/database.txt";
  67.             Path to the database file.  This is useful if you
  68.             want links to your page to automatically be added
  69.             one per line to a database (for use in Random Link
  70.             or other similar programs).  Must be chmoded to
  71.             777.
  72.  
  73. LINKS.HTML
  74. This file contains all of the links that users have added.  Users will be 
  75. automatically returned to this document.  You must place this document in a 
  76. directory with 777 file access and then chmod this file 777.  You will need to 
  77. edit the action="" part of the <form> tag so that points to your links.pl file 
  78. at your cgi-bin.  You will also want to change the bottom link so users can get 
  79. back to your home page.  You can change anything above the <form> tag also... 
  80. Just don't change the <!--XXXX--> tags unless you want to edit the script.
  81.  
  82. -------------------------------------------------------------------------
  83.  
  84. Hopefully this is enough information to get your script up and running.  If 
  85. you want more information please mail me.
  86.  
  87. I love to hear feedback and if anyone can improve on this it would be greatly 
  88. appreciated.  There is no cost to use this script and you can freely modify it 
  89. any way you wish.  All that I ask is that you possibly include my name some 
  90. where in the file (not necessarily viewable by all users) and I would like to 
  91. know the url of where it is being used so that I can see my script in action!
  92. _____________________________________________________________________________
  93.  
  94. HISTORY
  95. Version 1.0     5/14/95 - Original links.pl created
  96. Version 2.0     5/20/95 - Patrick Kane re-wrote almost the entire script to make 
  97.                           it work better
  98. Version 2.1     8/05/95  - Added the count of links and date last modified to the 
  99.                            links.html file.
  100.                          - Changed all my <meta> tags to the appropriate comment 
  101.                            tag <!--XXXX-->
  102.                          - Added a datecom variable in the realization that just 
  103.                            the 'date' command was interfering with some of the 
  104.                            date commands located in the cgi-bin of some servers.
  105.                          - An HTML checker to remove all HTML tags a user might 
  106.                            try to put around their title.
  107.                          - Added quotes around the url to make the structure more 
  108.                            HTML compatible.
  109. Version 2.2     7/17/96  - Fixed a bug which allowed users to post obviously
  110.                invalid URLS.  Now they must start with http or ftp
  111.                and contain something that resembles a host name.
  112.              - Due to a high incidence of banner postings, 
  113.                the software was enhanced to prevent banners 
  114.                and images from being posted. Main reason for the
  115.                update.
  116.              - Checks (very simply) to see if the link has already
  117.                been added.  If so, it doesn't allow it to be added
  118.                again.
  119.              - Allows you to auto-add the URLs to a database for
  120.                Random Link Generator.
  121.              - Changed the form so that URL field defaults to http://
  122.                and title field holds 80 characters max.  (These can
  123.                be changed, but prevent people from being stupid and
  124.                using up tons of lines.)
  125.              - I took out references to 'grep' and 'date', two unix
  126.                commands, which made this incompatible with other OS's.
  127.                Now it should work on other OS's or be a trivial hack
  128.                to make it work.
  129.              - Added a linkstitle, so your Error pages will link back
  130.                to your site with the site's title.
  131.              - Cleaned up a bit.
  132. _____________________________________________________________________________
  133. Matt Wright - mattw@worldwidemart.com - http://www.worldwidemart.com/scripts/
  134.